home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 8 / The Arsenal Files Collection #8 (Arsenal Computer) (1996).ISO / doorware / newsie10.zip / NEWSIE.DOC < prev    next >
Text File  |  1996-10-05  |  4KB  |  102 lines
  1.  
  2.                          NEWSIE 1.00 - October 1996
  3.                     RIP Newspaper Builder by John Parlin
  4.   =========================================================================
  5.                             F R E E W A R E
  6.  
  7.  This software is provided as-is, free of charge and includes Turbo Pascal
  8.  6.0 source code.  The source code was written by John Parlin and has been
  9.  contributed  to  the  public  domain  in  the  interest of furthering the
  10.  program's development but  also  to  encourage others to create software.
  11.  
  12.  If you  add  to this program,  please  redistribute  the  source  code as
  13.  freeware to others so that they may use the enhancements or add even more
  14.  to the program.
  15.  =========================================================================
  16.  
  17.  NEWSIE is a utility that converts an ASCII text file into a RipScript
  18.  graphic resembling a newspaper.  The newspaper banner, headlines and
  19.  stories are configurable by you.
  20.  
  21.  To get started, create or edit a NEWSIE.TXT file.  NEWSIE looks for this
  22.  file whenever it is run.  This is the text of the news to be converted
  23.  into the RIP graphic.
  24.  
  25.  To make a headline (story title), proceed the line with ASCII character
  26.  number 11 which can be inserted in some text editors by entering CONTROL-P
  27.  then CONTROL-K.  Other editors might accept ALT-011.
  28.  
  29.  Example of a Headline (story title)
  30.  
  31.   New Utility Installed
  32.  
  33.  The story text must follow the title directly.  Proper font pitch and
  34.  spacking will be produced in the RIP graphic.
  35.  
  36.  Our example continues:
  37.  
  38.   New Utility Installed
  39.  I installed NEWSIE today to
  40.  create RIP newspaper articles.
  41.  So, those of you have are
  42.  calling with a RipScript
  43.  terminal, the bulletins are now
  44.  a lot fancier!
  45.   Free Membership
  46.  I will give a free 1-month
  47.  membership to the winner of this
  48.  month's Shut The Box game.
  49.  There's still plenty of time and
  50.  with the make-up day feature,
  51.  you can even make up for lost
  52.  time.  So go at, and have fun,
  53.  and let's be careful out there!
  54.  
  55.  Notice that the two stories appear one right after the other, separated by
  56.  a headline.  The story text lines may be no longer than 33 characters.
  57.  Right now, the program does not have an editor and the parser will just
  58.  grab the first 33 characters and disregard the rest.  So set your editor's
  59.  right margin at 33 when you're creating your stories.
  60.  
  61.  NEWSIE looks for the configuration file NEWSIE.CFG whenever it is run.
  62.  This file contains a list of parameters that NEWSIE operates under.
  63.  Here's an example:
  64.  
  65.  NEWSIE.CFG
  66.  
  67.  <top of file>
  68.  BANNER=Riverworks BBS
  69.  EDITOR=Ed Arenz
  70.  MOUSECLICK=YES
  71.  MOUSETEXT=^M
  72.  <end of file>
  73.  
  74.  There should be no blank lines and no spaces between the '=' character.
  75.  The settings are:
  76.  
  77.  BANNER      This is what goes on the banner of the RIP newspaper.  Keep it
  78.              limited to 18 characters.
  79.  
  80.  EDITOR      This is usually the Sysop name and it appears after "Editor in
  81.              Chief" on the newspaper.
  82.  
  83.  MOUSECLICK  If this is set to YES, then the entire newspaper is made into
  84.              a RIP mouse region and is therefore 'click-able'.
  85.  
  86.  MOUSETEXT   Everything after the '=' character will be sent to the BBS
  87.              whenever the newspaper is mouse clicked.  This is only
  88.              applicable if MOUSECLICK=YES.
  89.  
  90.  NEWSIE will enable a text window just below the newspaper at the bottom of
  91.  the screen.  If your BBS sends any text after the newspaper, it will
  92.  appear here.  The text window is 80 characters wide by 5 characters high
  93.  and uses a 80x43 font.  This means that NEWSIE can be implemented as a
  94.  bulletin menu.
  95.  
  96.  To run NEWSIE after NEWSIE.CFG and NEWSIE.TXT have been created or edited,
  97.  just run NEWSIE.EXE from the DOS command line.  The output file NEWSIE.RIP
  98.  will be created.  To view this file, use a RipScript editor or call from
  99.  your BBS and view it that way.
  100.  
  101.  
  102.